Editing NPC Visuals and Generating 
Matching Portraits 


This tutorial will guide you through editing a character’s appearance (Hope in this example) 
and generating a matching portrait. 


Tools You'll Need 


Moonglasses - BG3 Extended Toolkit 
BG3 Modders Multitool 


BG3 Search Engine 


Optional 
Notepad++ or Visual Studio Code 


Editing Character Visuals 


First we want to find the character visual resource for Hope, and override it. 


Open the Resource Manager via the button on the top bar (box of crayons). 


To filter out all other resources and only show character visuals, right click on the two teapots 
icon. 


a Ee & Filters: EERE] x= 


Gat @ 


Name Type GUID 
& S_LOW_RealHope_1947e869-a95d-43c6-81f7-b4c... CharacterVisualReso... ¢30798b2-ad55-338645b5-a5d855a67417 


Right click on Hope in the Resource Manager, and select Override in the Active Mod. 


Name Type 


Rename / move... 
Create New From Selected... 
Reimport resource... 


Open For Edit... 


You will know a resource is overridden because the name will end in 000. 


Double click on Hope’s name, and the Character Editor will open in a new window. Make 
any changes you like and save. 


Character Editor 


File Edit View 


sasa 


Body Editor ~ 4 X |S LOW Real... + | Properties Explorer vax 
[None = ml a 1947e869-a95d-43c6-81f7... 
g Type:| DWR F Base F | Filters | Animation) None D | speed. —I Play Stop CharacterViewModel S_LOW_RealHope_1947e869-a95d-43c6 


Visuals: DWR F NKD Body A ra | 


Icon scale: Large v Show Equipment Visuals 
Unequip All Override Parameters 
+ Unassigned Head X Body X Presets 


Footwear X Hair DWR X Headwear X G Attachments 


¥ Selected Visuals 


All Visuals 


While we are in the character editor, we will save this character visual as a template (we will 
need it later). 


Select File > Save Preset 


Character Editor 
Edit View 


Open Character Visual 


Close 


Save CTRL+S 
Save All CTRL+Shift+S 


Load Preset 


; 


I recommend saving the preset into the Shared project (this way your saved presets will be 
available to all your projects) and the CharacterVisuals package. Choose a resource name 
(I recommend using a prefix to help searching for it later), and click Create Resource. 


“y Create Resource 


Shared 


TP CharacterVisuals 


Generated 

Generated ed539163-bb70-431b-96a7-f5b2eda5376b 
Key Art 

PreProd Prototypes 

Test 

Ul 


Resource Name Z HopePreset 


The character visual part is now done, and the NPC will reflect the changes we have made 
in game. The portrait icon however, will still be the old vanilla portrait. 


Generating a New Character Portrait Icon 


First, we will gather some important information. 
1. Hope's icon UUID. 
2. Her parent Root Template 


We will use the BG3 Search Engine https://bg3.norbyte.dev/search to find what we need. 


S LOW RealHope | Local Character 1947¢869-a95d-43c6-81f7-b4c4f90d95ce 


<GameObjects> 
<AnubisConfigName>LOW_HouseOfHope_Hope</AnubisConfigName> 
<Archetype>mage</Archetype> 
<CanFight>False</CanFight> 


<CanJoinCombat>False</CanJoinCombat> 


-a5d855a67417</CharacterVisualResourceID> 


<DisplayName>hcicb14figiccbg4771gae7 
<Equipment /> 


<LevelOverride>10</LevelOverride> 


<MapKey>1947e869- a95d-43c6-81f7 -b4c4f9e0d95ce</MapKey> 
<Name>S_LOW_RealHope</Name> 
<Stats>LOW Hope</Stats> 


1. Hope’s icon UUID: 
€30798b2-ad55-3386-f5b5-a5d855a67417-_(lcon_Dwarf_Female) 
2. Her parent Root Template: Dwarves Female Hill Guard Caster 
Save this info, we will need it later. 
Next, we will need to set a Photo Booth Level for our project. 
Select Project > Project Settings and then the General tab. 
Click the ellipsis (...) next to Photo Booth Level, and choose SYS_PortraitGeneration_A 


and click save. 
`s Project Settings x 


Properties Dependencies Geeni “ofits 


General Settings 


Configure your project's main levels and general gameplay settings 


Authenticate 


Main Levels 


Startup Level 
Character Creation Level 
Lobby Level 


Menu Level 


Photo Booth Level 


Gameplay 


Number of Players 4 = (2-4) 


Game Scripts 


Now we are ready to generate a new portrait. 


Select File > Load Level and choose Basic_Level_A. 


`> Browser 


Levels New Level Save Games Bookmarks 


Select your level Create+ Enter Sandbox 


Recent — 


Baldur's Gate 


SYS_PortraitGeneration_A CTY Main A Basic Level A 


To generate a portrait for any character, we need to drag their root template from the Root 
Templates window. 


Unfortunately, most NPCs don't have a root template that can be found here. Some do, 
Counsellor Florrick (S GLO Desire) for example. 
Root Templates 

SoA BG & | E fori x |4 oree 


item view Inheritance view > [WIP] BASE Bipedal » [WIP] BASE Bipedal Civil » [WIP] BASE Elves > 
Name 


+ All 


= Shared 


F] 
I 


Shared 
[WIP] CINE_LOW_FlorrickConfrontati 


[WIP] CINE_LOW_FlorrickConfrontatic 


* DiceSet_01 


* DiceSet_03 


= DiceSet_06 


> > > > > 


[WIP] S GLO Desire HangedPhysics 


= Maint I 


Hope is not there, so we will need to create a root template for her. 


We can use the root template Dwarves Female Hill Guard Caster (Hope’s parent root 
template that we wrote down earlier) for this. 


Search for Dwarves Female Hill Guard_Caster, right-click on it and select Create new 


from selected 
Root Templates [ Create new from selected... 


Create inherited from selected... 
SoA E a & | El Dwanes e Hill Guard Caster x 
= ad | = = | Find references to this template 


Item view Inheritance view > [WIP] BASE Bipedal » List dependencies of this template 


Move To Another Mod... 
Active Mod... 


v All 


* Shared 


We are now presented with the Create Object Wizard window. We need to fill out the 
following fields: Select Mod, Character Visual Resource and Name 


CreateObiectWizard 


Al Bounds Move © ght: 1.6};Hit Cylinder (Radius: 0.2, Height: 1.6};Stand Cylinder (Radius: 0.499, Hi 

Animation 

Equipment Types 5- 2f8; 896f8a20-7dda-4bff-b7 21 cc7b; 41350 78b6-4c6d-8 ce7 d633-d496-4431 
Base 

Camera Offset 0.00 4> 0.00 4> 0.00 

Character Visual Resource BASE_Dwarves_Female_b98a80f4-20dc-4666-9b5b-2993b38034ed Y 

DevComment 

Display Name Dwarf Guard 

Equipment Class Dwarf Female x 

File Name G:/SteamLibrary/steamapps/common/Baldurs Gate 3/Data/Public/Shared/RootTemplates/ccc03a3f-7a23-4780-9c34-dd6d3f13b1c6.lsf 

GUID 

Labels 

Level Name 


Name 


) Name 


Divanves: Female Bill Guard Caster 


There is already a template with name Dwarves_Female_Hill_ Guard Caster 


For Select Mod, select the name of the current mod. 


For Character Visual Resource, click on the ellipsis icon (...) and it'll open the familiar 
character editor window. You will notice that the character is blank, with no clothes or hair. 
We will use the preset we saved earlier to re-create Hope. 


Select Load Preset (the human figure icon), then search for the preset we made earlier. Say 
yes to the pop-up asking if you want to remove all existing visuals. Save and close the editor. 
File Edit View 


w es sal `z Open Resource 


Body Editor <00000000-0000-0000-0000-000000000000> 


Rig Type:| DWR_F_Base 


Visuals:} DWR F NKD Body / á epee 


4 Content 


4 Character\ii 
Z_HopePreset 


Unassigned 


The last thing we need to do in the wizard is choose a name for the root template (Z_Hope in 
this example), then click create. 


Search for your new root template, left-click on it and drag the character into the level editor 
window. Left-click again to drop them in. 


x 


> [WIP] BASE Bipedal » [WIP] BASE F.pedal Civil » [WIP] B 


Name 


| Guard_Caster 


Once our character is standing in the level, we can go ahead and take their photo. 


Select Project > Render character portraits 
Select the current mod, and then Render portraits. 


Project v] Hope Restyled 


Project Setti 
Render portraits. 


Convert Ul / 
Render Fartinment Irans Render specific portraits. Start rendering npc portraits for this mod. 


Render character portraits. 


Generate Ul Textures Metadata > 


You will be asked if you want to load the booth level, say yes. 


Once it’s done, it'll leave you in the booth level. Load Basic_Level_A again if you want to test 
if the new portrait is working. 


Click on the Switch Game/Editor icon (a controller) and the level will switch to game mode. 
a K or 
You can then right-click on your character, select examine and if everything is working 


correctly the new portrait will display. If the icon is blank, you will need to reload the editor for 
it to update and display. 


FYI, all portraits generated by the editor are exported to this folder “Baldurs Gate 
3\Data\Editor\Temp\lconGenerator’. 


We can now publish our mod as a .pak file. We're not done yet though. We have generated 
a portrait for our new root template, not the actual character whose appearance we have 
changed. We now need to edit the metadata. Isf.Isx file with the correct UUID. 


Use the BG3 Modders Multitool to unpack the .pak file. 


Baldur's Gate 3 Modder’s Multitool - O X 
Utilities Shortcuts Help Configuration 


,==>=—==—=—=—=—=—L 


I \ v4 UUID/TranslatedString Handle Generator 
I Generate Handle 
I 
I Search Index 
I Drop mod | 
I 
I 
I workspace folder 1 D:\Documents\BG3 Stuff\Guides\Hope_Restyled_f7dd2b32-fid0- 
d528-3d0c-831325e7db35 
' oramod.pak 1 ae CNE 
I I Major Minor Revision Build Launch Game 
I here I ey ot ot HH 
I Configuration needed: 
\ I Packing Priority: 304 Compression: LZ4 v missing bg3.exe! 
es ee ae eee ee ee d Pack .paks to Mods folder instead of zipping 


Open the unpacked mod folder, the files we will need are in the following folders: 


Portrait Icon:Mod Name\Mods\Mod Name\GUI\Assets\Portraits\filename.DDS 
The .DDS extension needs to be all caps, with a size of 152x152. 


Metadata file: Mod Name\Mods\Mod Name\GUI\metadata.|sf.Isx 
The double extension is used by the multitool for conversion into a .Isf file. 


First we will need to rename the portrait icon file. Use the icon UUID that you wrote down 
earlier. In this example our new portrait icon filename will be 
€30798b2-ad55-3386-f5b5-a5d855a67417-_(lcon_Dwarf_Female).DDS 


Next we will edit metadata.Isf.Isx and update the correct filename. 
Note that the extension here is .png. The DDS file is converted to .png when loaded into the 
game. 


<?xml version="1.0" encoding="yb£-8"?> 
E<save> 
<version major="4" minor="7" revision="1" build="3" 1slib meta="vl,bswap guids,lsf keys adjacency" /> 
=) <region id="gonfig"> 
E <node id="gonfig"> 
=] <children> 
= <node id="entries"> 
=) <children> 
= <node.id="obi 


<attribute id="MapKey" type="FixedString" value="Assets/Portraits/e30798b2-ad55-3386-£5b5-a5d855a67417- (Icon Dwarf Female) .png" /> 


=) <node id="entries" 

<attribute " type="int16" value="152" /> 
<attribute id=""ipgeunt" type="int8" value="8" /> 
<attribute id="w" type="int16" value="152" /> 


</node> 
</children> 
</node> 
</children> 
</node> 
</children> 
</node> 
</region> 


a 


</save> 


Once done, we can use the Multitool to pack the folder back into a .pak file. 


And we're all done. 


